home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / olrdrs / sxr401.zip / SYSFILES.ZIP / SYSFILES.DOC < prev    next >
Text File  |  1994-06-01  |  5KB  |  152 lines
  1. ====================================
  2.  Silver Xpress Reader Systems Files
  3. ====================================
  4.  
  5. This section will describe the system files and locations (files defined
  6. optional or mandatory) expected by Silver Xpress.  This should assist in
  7. the LAN management or multi-user system setup for the Silver Xpress Reader.
  8. You may use this information to better "separate" the system files between
  9. users.
  10.  
  11. GLOSSARY:
  12.  
  13.   PROGRAM PATH     The directory location of the XPREAD.EXE program.
  14.  
  15.   STARTUP PATH     The current directory location when XPREAD.EXE started.
  16.  
  17.   XSFP             Optional Xpress System Files Location.
  18.  
  19.   XOL              Optional Location of XPREAD.OVR overlay file.
  20.  
  21.   XESP             If the Xpress swap file $SXSWAP.$$$ is written to disk,
  22.                    it will be placed in the current directory.  This swap
  23.                    directory can be defined using the XESP environment
  24.                    string.
  25.  
  26.   DOS PATH         This is the DOS PATH statement for the user or
  27.                    workstation or multi-tasking session.
  28.  
  29.   SEARCH PATH      A list of directories where Xpress will look for most
  30.                    files.
  31.  
  32. FINDING FILES (SEARCH PATH)
  33.  
  34.   Silver Xpress will use the following FILE SEARCH RULE when it is looking
  35.   for files.  Only the files indicated below in the SYSTEM FILES table use
  36.   this rule.
  37.  
  38.   FILE SEARCH RULE USED TO DEFINE THE SEARCH PATH
  39.  
  40.        1) startup directory
  41.        2) optional XSFP location
  42.        3) program path (location where XPREAD.EXE was found)
  43.        4) DOS path
  44.  
  45. MULTI-USER SETUP:
  46.  
  47.   Without getting into technical detail, there is 1 ideal way to a create
  48.   multiple user setup.
  49.  
  50.   No matter what, the basic goal is to help separate files, in particular
  51.   list files, and also share some of the same files.
  52.  
  53.   Since the FILE SEARCH RULE stipulates that somes files will be searched
  54.   in the startup directory first and others in the program directory, users
  55.   can PUT their customized files in their personal directory.
  56.  
  57.   1) Create a USER directory for each user such as:
  58.  
  59.                 \XPRESS\HECTOR
  60.                 \XPRESS\ANDI
  61.  
  62.      Then use a batch file:
  63.  
  64.      SX.BAT
  65.  
  66.         IF .%1 .. . goto HELP
  67.           C:
  68.           CD \XPRESS\%1
  69.           SET XSFP=C:\XPRESS\%1
  70.           C:\UTILS\XPREAD.EXE
  71.           SET XSFP=
  72.           GOTO EXIT
  73.         :HELP
  74.           ECHO usage: SX [username]
  75.         :END
  76.  
  77. FILES:
  78.  
  79.                   ----------------------------------------
  80.                    Location Information
  81.                   ----------------------------------------
  82.  
  83.   XPREAD.EXE      REQUIRED:
  84.  
  85.                    The main executable is XPREAD.EXE.  It can be in the
  86.                    current directory or in a directory defined on the PATH.
  87.                    The PROGRAM PATH is where the program is located.
  88.  
  89.   XPREAD.OVR      REQUIRED:
  90.  
  91.                    Same location as XPREAD.EXE or defined by XOL
  92.                    environment string.  If XOL is not defined, the
  93.                    XPREAD.OVR is expected in the same directory as
  94.                    XPREAD.EXE.  IF the XPREAD.EXE is renamed, the overlay
  95.                    must be renamed as well.
  96.  
  97.   $SWSWAP.$$$     REQUIRED BUT HIDDEN FILE:
  98.  
  99.                    This is the temporary Xpress Swap file.  It is
  100.                    optionally used when Xpress shells to DOS to run 3rd
  101.                    party programs.  If your system has EXPANDED or EXTENDED
  102.                    MEMORY, the $SWSWAP.$$$ file will be placed there.
  103.                    Otherwise it is written to disk. When Xpress returns
  104.                    from the outside program, the swap file is deleted.
  105.  
  106.                    If the swap file is written to disk, it will be placed
  107.                    in the current directory.  This swap directory can be
  108.                    defined using the XESP environment string.
  109.  
  110.   XPREAD.CFG      REQUIRED:
  111.  
  112.                    The Xpress configuration will be located in the SEARCH
  113.                    PATH.  You may use the -C switch to override the
  114.                    configuration file name and location.
  115.  
  116.   SXMENU.LIB      REQUIRED:
  117.  
  118.                    The Xpress Menu Library will be located in the PROGRAM
  119.                    PATH.  You may use the -C switch to override the
  120.                    configuration file.
  121.  
  122.   LIST FILES      OPTIONAL:
  123.  
  124.                    If a list file is not fully declared, Xpress will follow
  125.                    the FILE SEARCH RULE defined above.
  126.  
  127.   XPREAD.CLR      OPTIONAL:
  128.  
  129.                    Expected in the SEARCH PATH
  130.  
  131.   XPREAD.HLP      REQUIRED (OPTIONAL FOR REGISTERED USERS)
  132.  
  133.                    Expected in the SEARCH PATH
  134.  
  135.   ARCHIVER.DEF    OPTIONAL:
  136.  
  137.                    Expected in the SEARCH PATH
  138.  
  139.   XPREAD.KEY      REQUIRED (NOT AVAILABLE DURING FIRST TIME USAGE)
  140.  
  141.                    Expected in the SEARCH PATH
  142.  
  143.   XPREAD.LOG      OPTIONAL
  144.  
  145.                    Expected in the PROGRAM PATH.  Can be defined in
  146.                    configuration.
  147.  
  148.   XPLANG.DEF      REQUIRED
  149.  
  150.                    Expected in the SEARCH PATH
  151.  
  152.